Skip to content

docs: alinhar contrato ao backend (signup, cash-in/out, webhooks, cenários) - #4

Merged
adsonrodrigues merged 2 commits into
mainfrom
docs/align-contract-with-backend
Jun 30, 2026
Merged

docs: alinhar contrato ao backend (signup, cash-in/out, webhooks, cenários)#4
adsonrodrigues merged 2 commits into
mainfrom
docs/align-contract-with-backend

Conversation

@adsonrodrigues

Copy link
Copy Markdown
Member

Alinha a doc ao contrato real do backend (public-ms = fonte da verdade; whitelist + forbidNonWhitelisted)

openapi.json

  • signup: required = email/holderName/entityType; +razonSocial condicional; holderTaxIdPrimary opcional; holderTaxIdPrimaryType/accountType deprecados; isSandbox default true
  • cash-in/out: required corretos; remove aliases Voluti (amount/payer_name/conciliationId/receiverClabe/receiverName/bankCode) — backend rejeita; CLABE só 18 dígitos; remove externalId do cash-out
  • webhooks events: exatamente 1 (era 1–5)
  • adiciona paths faltando: /api/balance, /api/transactions, /api/webhooks-config/test
  • remove path fantasma /api/spei/transaction/{externalId} (sem rota no backend)

Guias (pt-br/en/es)

  • get-started: +customerEmail no exemplo de cash-in (antes daria 400)
  • cash-in: marca customerName/customerEmail como obrigatórios
  • X-Sandbox-Scenario: valores canônicos (corrige cash_in_failed, error:*, delayed:Ns)
  • signup/quickstart/sandbox: exemplos atualizados pro contrato novo; webhook examples → 1 evento

⚠️ Pendente (decisão): migrating-from-voluti.mdx ainda promete os aliases Voluti removidos — fora deste PR.

🤖 Generated with Claude Code

Backend é a fonte da verdade (whitelist + forbidNonWhitelisted).

- signup: contrato novo (required email/holderName/entityType + razonSocial
  condicional; holderTaxIdPrimary opcional; holderTaxIdPrimaryType/accountType
  deprecados; isSandbox default true).
- spei cash-in/out: required corretos; remove aliases Voluti (rejeitados pelo
  backend); CLABE somente 18 dígitos; remove externalId do cash-out.
- get-started: adiciona customerEmail no exemplo de cash-in.
- webhooks: events = exatamente 1.
- X-Sandbox-Scenario: padroniza nos valores canônicos (corrige cash_in_failed,
  error:*, delayed:Ns).
- openapi: adiciona paths /balance, /transactions, /webhooks-config/test;
  remove path fantasma /spei/transaction/{externalId}.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 30, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
ntxpay-292c296a 🟡 Building Jun 30, 2026, 2:51 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

…dor)

- Deleta os guias en/es migrating-from-voluti.mdx (expunham Voluti/magenpay
  e ainda prometiam aliases já removidos).
- Remove os Cards "Migrating from Voluti" dos index en/es.

Todos os integradores são clientes NTX; Voluti não aparece na doc pública.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@adsonrodrigues
adsonrodrigues merged commit aa72b8d into main Jun 30, 2026
2 checks passed
@adsonrodrigues
adsonrodrigues deleted the docs/align-contract-with-backend branch June 30, 2026 03:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant